Setting Properties of an XForm

This topic describes the procedure to define the properties of an XForm.

You can define the properties of an XForm using its property sheet.

1. Open the XForm in the XForms Designer.
2. Double-click the Designer Area, or right-click it and select Properties. Alternately, to view the property sheet of an XForm that contains split areas or regions, right-click the Designer Area Well and select Properties. The Form window appears.
3. Click Javascript to expand the pane. An empty row is displayed in the Javascript pane. You can add JavaScript files containing custom scripts to customize the XForm.
4. Type the URL (relative path) of the JavaScript file to be attached to the XForm in the empty row.

   Note: You can add multiple JavaScript files to the XForm and execute them like web page scripts. To do so, click , and specify the respective URLs in the empty rows added to the pane.

5. Click Stylesheet to expand the pane, and click . An empty row is added in the Stylesheet pane. You can specify custom style sheets to apply to the XForm.
6. Click , select a style sheet from the Select stylesheet - CSS dialog box that appears, and click OK.

   Note:

   • You can add multiple style sheets to the Stylesheet pane in the Form window. The style sheets are applied to the XForm in the order in which they are added.
   • Only the stylesheets that are uploaded to a project are available in the Select stylesheet - CSS dialog box. For information about uploading any document to a project, see Uploading a Document to the Project.
   • You can click New in the Select stylesheet - CSS dialog box to create a style sheet. Define the stylesheet in the Untitled CSS.css window that appears and save it.
   • If you edit a stylesheet in the project, you must publish it to ensure that the changes apply to the documents where it is used.
7. If the XForm is involved in a workflow, click Workflow Events and select an option from the Before CompleteTask drop-down list to specify the Web service operation to be executed before a task is executed.
8. Click Feedback Properties to alter the display settings of the error and notification messages. These properties can be applied to input and select controls only:
   • Check Show Error to enable the error display for the input/select control.
   • Check Show Notification to enable the notification display for the input/select control.

     Note: By default, both the properties will be checked.

9. Click Events and make the appropriate modifications:
   • Select an option from the Init drop-down list to specify the Web service operation to execute after the XForm is loaded and before a request is fired to the backend to retrieve data.
   • Select an option from the Init Done drop-down list to specify the Web service operation to execute after data is received from the backend and is rendered on the XForm.
   • Select an option from the Before Close drop-down list to specify the Web service operation to execute before the XForm is closed.

     Note:
     You can also use the Script Editor for associating data with the events of an XForm. To do so, click for each event and use the Script Editor to define the script.

10. Click Form Messages and specify the messages to be displayed when an XForm is closed.
    • In the Save Confirmation Message field, type the message to be displayed when the XForm is closed without saving its changes.
    • In the Synchronized Dialog Close field, type the message to be displayed when the XForm is closed without saving the changes made in a synchronized dialog.
11. Check Set Focus at Startup to specify that the first control on the XForm receives focus when the XForm is loaded.

    Note:
    The Set Focus at Startup check box is selected, by default.

12. Check Transitional to enable multi-browser support for the XForm. For more information, see Enabling Multi-browser Support for Web Content.

The required settings for the XForm are defined.